home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
batchut
/
batmnu21.zip
/
BATMNU21.DOC
< prev
next >
Wrap
Text File
|
1992-07-11
|
23KB
|
608 lines
┌─────────────────────────────────────┐
│ ╔═══════════════════════════════╗ │▒▒
│ ║ ║ │▒▒
│ ║ BATMNU.EXE ║ │▒▒
│ ║ Batch File Menu System ║ │▒▒
│ ║ Version 2.1 ║ │▒▒
│ ║ ║ │▒▒
│ ╚═══════════════════════════════╝ │▒▒
└─────────────────────────────────────┘▒▒
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
July 11, 1992
TABLE OF CONTENTS
INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
MENU FORMAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
General Format Rules . . . . . . . . . . . . . . . . . . . . . . . . 1
Window Options . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Color Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Window Appearance . . . . . . . . . . . . . . . . . . . . . . . . . 3
Option Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Option Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Headers and Footers . . . . . . . . . . . . . . . . . . . . . . . . 4
WHAT HAPPENS IN THE BATCH FILE? . . . . . . . . . . . . . . . . . . . . . 4
MENUS WITH PARAMETERS . . . . . . . . . . . . . . . . . . . . . . . . . . 5
MOUSE SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
SHAREWARE INFORMATION . . . . . . . . . . . . . . . . . . . . . . . . . . 7
BATMNU.EXE History . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
BATMNU.EXE
Warren Small
(c) 1992
INTRODUCTION
This program is a menuing system for use with your batch files. It is not
intended to be a shell, although with some very ambitious batch file
programming, it could be used as one. Its purpose is to provide sophisticated
flow control and give batch files a professional appearance by creating a
point-and-shoot menu with up to 26 options per menu. The cursor keys and the
HOME and END keys can then be used to make the selection. Each option can be
selected by a 'hotkey' defined by your menu. A mouse is also supported if
detected.
Syntax: BATMNU [d:][path]filename [label] [default]
The program defaults to an extension of "mnu" if none is provided. The
filename can be a separate file or, if you prefer, the menu can be within the
calling batch file. You will have to code the batch file so those lines are
never executed, of course. If a separate file is used, it can be 'hidden'
making it more secure from tapering.
The optional label parameter can be used if you wish to put more than one
menu within the file. Bracket your menu lines with ":label" and ":end_label".
BATMNU will search your path for the file if it's not in the current
directory. The label can be up to 15 characters long.
The default parameter on the command line is used if you want an option other
than the first one to be highlighted when the menu starts. e.g. "BATMNU
NORTON.BAT 3" will highlight the third option.
MENU FORMAT
:menu {keyword to mark where the program should start reading}
header,header text
h_format,fYEL,bred,t1,d1 {header colors, time, date}
window,tRED,hWHI,... {colors and window appearance definition}
title,title text
option,option text,[#] {# indicates hotkey position in option text}
help,help text {must follow option help refers to}
option,option text,[#][,[drive],[directory],program] {optional format}
option...
.
.
.
footer,footer text
f_format,fYEL,bred,t1,d1 {footer colors, time, date}
:end_menu {Program stops reading and closes the file}
- General Format Rules -
The definition can be organized in almost any order as long as it is placed
between the ':menu' and ':end_menu' keywords (or other label if provided on
the command line). The window line should appear before the options if you
use the 'l', 'n' or 'a' parameter. Maximum title length is 55 characters.
Page 1 of 8
Ver. 2.1
BATMNU.EXE
Warren Small
(c) 1992
Headers and footers can be 70 characters long if the time and/or date are not
used. If you leave the title out, your menu will contain only your defined
options. Header and footer are optional. Maximum option length is 50
characters for single column menus and 25 characters for double column.
Maximum help length is 70 characters.
All parameters on the window, h_format and f_format lines are separated by a
comma. Spaces are ignored. The keywords can be indented for clarity, if
desired, using spaces or TABs.
- Window Options -
The "window" line in your menu will define the colors and appearance of your
menu. The color options are:
f - foreground color of window (0-15)
b - background color of window, (0-7)
t - title color (0-15)
o - option color (0-15)
h - hotkey color (0-15)
k - screen color (clears screen), foreground (0-15) & background (0-7)
e - screen border color (0-15)
Color options should be followed by one of the color values shown in the
chart below. Hotkeys can be made invisible by using "hinv" on the window
line. The hotkeys will still select the options but the menu will not
indicate them. This gives you the look of a simpler "light bar" style menu.
- Color Values -
0 or bla = Black 8 or BLA = Grey
1 or blu = Blue 9 or BLU = Bright Blue
2 or gre = Green 10 or GRE = Bright Green
3 or cya = Cyan 11 or CYA = Bright Cyan
4 or red = Red 12 or RED = Bright Red
5 or mag = Magenta 13 or MAG = Bright Magenta
6 or yel = Brown 14 or YEL = Yellow
7 or whi = White 15 or WHI = Bright White
The 'k' option fills double duty setting the foreground and background color
for the screen. The first k parameter will set the background, the second the
foreground (Foreground default is "whi" if not specified). The foreground
color is used with the fill character. The fill character can appear after
the color of either to give the screen background more interest than a flat
color. Use of the drop shadow is more dramatic too.
If you prefer, a string could be used to fill the screen background. Either
words or special characters could be used. Put the string after the color as
above. If you want to add spaces, use the underscore (_) character. It will
be treated as a space when displayed. (e.g. kred_Main_Menu)
Page 2 of 8
Ver. 2.1
BATMNU.EXE
Warren Small
(c) 1992
The 'e' option sets the screen border color which is outside the normal text
area. An 'e' used alone will reset the border to its normal black.
Default colors are provided (fYEL, bblu, tWHI, oCYA, hRE